r"""
正则表达式
re.match(pattern, string, flags=0)
    从开头开始匹配，返回一个匹配结果，失败返回None
    
re.fullmatch(pattern, string, flags=0)
    是match函数的完全匹配版本，失败返回None
    
re.search(pattern, string, flags=0)
    返回一个匹配结果，失败返回None
    
sub(pattern, repl, string, count=0, flags=0)
    用`repl`替换符合`pattern`的字符串,count用于指定最多替换次数，不指定时全部替换。
    
re.subn(pattern, repl, string, count=0, flags=0)
    返回一个元组，其中包含新字符串,以及所有替换的总数

re.split(pattern, string, maxsplit=0, flags=0)
    根据`pattern`分割字符串
    
re.findall(pattern, string, flags=0)
    返回所有符合`pattern`的字符串列表
    
re.finditer(pattern, string, flags=0)
    返回所有符合`pattern`的字符串列表，返回迭代器
    
re.compile(pattern, flags=0)
    返回一个正则对象
    ```code
    >>match = re.compile('abc')
    >>match.search('abcdefg')
    ```
注[1] flag参数:
| 修饰符 | 描述                                                         |
| :----- | :----------------------------------------------------------- |
| re.I   | 使匹配对大小写不敏感                                         |
| re.L   | 做本地化识别（locale-aware）匹配                             |
| re.M   | 多行匹配，影响 ^ 和 $                                        |
| re.S   | 使 . 匹配包括换行在内的所有字符                              |
| re.U   | 根据Unicode字符集解析字符。这个标志影响 \w, \W, \b, \B.      |
| re.X   | 该标志通过给予你更灵活的格式以便你将正则表达式写得更易于理解。 |

注[2] 正则表达式修饰符：
| 模式        | 描述                                                         |
| :---------- | :----------------------------------------------------------- |
| ^           | 匹配字符串的开头                                             |
| $           | 匹配字符串的末尾。                                           |
| .           | 匹配任意字符，除了换行符，当re.DOTALL标记被指定时，则可以匹配包括换行符的任意字符。 |
| [...]       | 用来表示一组字符,单独列出：[amk] 匹配 'a'，'m'或'k'          |
| [^...]      | 不在[]中的字符：[^abc] 匹配除了a,b,c之外的字符。             |
| re*         | 匹配0个或多个的表达式。                                      |
| re+         | 匹配1个或多个的表达式。                                      |
| re?         | 匹配0个或1个由前面的正则表达式定义的片段，非贪婪方式         |
| re{ n}      | 精确匹配 n 个前面表达式。例如， **o{2}** 不能匹配 "Bob" 中的 "o"，但是能匹配 "food" 中的两个 o。 |
| re{ n,}     | 匹配 n 个前面表达式。例如， o{2,} 不能匹配"Bob"中的"o"，但能匹配 "foooood"中的所有 o。"o{1,}" 等价于 "o+"。"o{0,}" 则等价于 "o*"。 |
| re{ n, m}   | 匹配 n 到 m 次由前面的正则表达式定义的片段，贪婪方式         |
| a\| b       | 匹配a或b                                                     |
| (re)        | 对正则表达式分组并记住匹配的文本                             |
| (?imx)      | 正则表达式包含三种可选标志：i, m, 或 x 。只影响括号中的区域。 |
| (?-imx)     | 正则表达式关闭 i, m, 或 x 可选标志。只影响括号中的区域。     |
| (?: re)     | 类似 (...), 但是不表示一个组                                 |
| (?imx: re)  | 在括号中使用i, m, 或 x 可选标志                              |
| (?-imx: re) | 在括号中不使用i, m, 或 x 可选标志                            |
| (?#...)     | 注释.                                                        |
| (?= re)     | 前向肯定界定符。如果所含正则表达式，以 ... 表示，在当前位置成功匹配时成功，否则失败。但一旦所含表达式已经尝试，匹配引擎根本没有提高；模式的剩余部分还要尝试界定符的右边。 |
| (?! re)     | 前向否定界定符。与肯定界定符相反；当所含表达式不能在字符串当前位置匹配时成功 |
| (?> re)     | 匹配的独立模式，省去回溯。                                   |
| \w          | 匹配字母数字及下划线                                         |
| \W          | 匹配非字母数字及下划线                                       |
| \s          | 匹配任意空白字符，等价于 **[ \t\n\r\f]**。                   |
| \S          | 匹配任意非空字符                                             |
| \d          | 匹配任意数字，等价于 [0-9].                                  |
| \D          | 匹配任意非数字                                               |
| \A          | 匹配字符串开始                                               |
| \Z          | 匹配字符串结束，如果是存在换行，只匹配到换行前的结束字符串。 |
| \z          | 匹配字符串结束                                               |
| \G          | 匹配最后匹配完成的位置。                                     |
| \b          | 匹配一个单词边界，也就是指单词和空格间的位置。例如， 'er\b' 可以匹配"never" 中的 'er'，但不能匹配 "verb" 中的 'er'。 |
| \B          | 匹配非单词边界。'er\B' 能匹配 "verb" 中的 'er'，但不能匹配 "never" 中的 'er'。 |
| \n, \t, 等. | 匹配一个换行符。匹配一个制表符。等                           |
| \1...\9     | 匹配第n个分组的内容。                                        |
| \10         | 匹配第n个分组的内容，如果它经匹配。否则指的是八进制字符码的表达式。 |

注[3] 正则表达式实例：
    **字符类**
    | 实例         | 描述                               |
    | :---------- | :-------------------------------- |
    | [Pp]ython   | 匹配 "Python" 或 "python"         |
    | rub[ye]     | 匹配 "ruby" 或 "rube"             |
    | [aeiou]     | 匹配中括号内的任意一个字母        |
    | [0-9]       | 匹配任何数字。类似于 [0123456789] |
    | [a-z]       | 匹配任何小写字母                  |
    | [A-Z]       | 匹配任何大写字母                  |
    | [a-zA-Z0-9] | 匹配任何字母及数字                |
    | [^aeiou]    | 除了aeiou字母以外的所有字符       |
    | [^0-9]      | 匹配除了数字外的字符              |
    | .    | 匹配除 "\n" 之外的任何单个字符。要匹配包括 '\n' 在内的任何字符，请使用象 '[.\n]' 的模式。 |

    **特殊字符类**
    | 实例  |  描述                                                        |
    | :--- | :---------------------------------------------------------- |
    | \d   | 匹配一个数字字符。等价于 [0-9]。                             |
    | \D   | 匹配一个非数字字符。等价于 [^0-9]。                          |
    | \s   | 匹配任何空白字符，包括空格、制表符、换页符等等。等价于 [ \f\n\r\t\v]。 |
    | \S   | 匹配任何非空白字符。等价于 [^ \f\n\r\t\v]。                  |
    | \w   | 匹配包括下划线的任何单词字符。等价于'[A-Za-z0-9_]'。         |
    | \W   | 匹配任何非单词字符。等价于 '[^A-Za-z0-9_]'。                 |
"""
import re

s = """abc123efg345"""

match_result = re.match(r'([a-z]+)([0-9]+)', s)
print(match_result.groups())

print(re.findall('3', s))

print(re.sub('3', '0', s))

print(re.subn('3', '0', s))

s = '1102231990xxxxxxxx'
res = re.search(r'(?P<province>\d{3})(?P<city>\d{3})(?P<born_year>\d{4})', s)
print(res.groupdict())
